home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / utils1 / fe302.arj / FE.DOC < prev    next >
Text File  |  1994-01-07  |  13KB  |  334 lines
  1.  
  2.   FastErase version 3.02, Copyright (c) 1993, 1994 Arjen Wolfs
  3.   This documentation was written by Arjen Wolfs, January 7th, 1994.
  4.  
  5.   Contents of this document:
  6.     - WARNING
  7.     - INTRODUCTION
  8.     - FEATURES
  9.     - REQUIREMENTS
  10.     - HOW IT WORKS
  11.     - IMPORTANT NOTE ON OPTIONS
  12.     - EXAMPLES
  13.     - EXIT CODES
  14.     - TESTING THE PROGRAM YOURSELF
  15.     - DISCLAIMER
  16.     - DISTRIBUTION/USAGE RESTRICTIONS
  17.     - CONTACTING THE AUTHOR
  18.  
  19.  
  20.   WARNING
  21.   
  22.   You are strongly advised to read this manual thoroughly. 
  23.   If you you start using with this program without really 
  24.   knowing what you're doing, unrecoverable data loss may be
  25.   the result!
  26.  
  27.   
  28.   INTRODUCTION
  29.  
  30.   FastErase is an erasing utility. So what? you might say, what
  31.   do I need an erasing utility for? DEL and DELTREE are good 
  32.   enough for me. Okay then, try to figure out how you would 
  33.   complete the following tasks with DEL or DELTREE, in ONE command:
  34.  
  35.      - Erase all .BAK files on drive C
  36.      - Erase all .BAK files on drives C, D, E and F
  37.      - Erase all .BAK files AND all .OLD files on drive C
  38.      - Erase all files on drive C, created before September 24th, 1987
  39.      - Erase all files on drives C and E, created between
  40.        October 11th, 1989 and May 17th, 1991
  41.      - Erase all files on drive C, with a length of zero bytes (empty files)
  42.      - Erase all .BAK files on drive C, EXCEPT all files named MIRROR.BAK
  43.      - Erase all files on drives C and F, beginning with the letter C,
  44.        EXCEPT all files named COMMAND.COM and CONFIG.SYS.
  45.      - Erase your computer diary, stored in file DIARY.DOC, but make it
  46.        unrecoverable, so your wife/husband/mother/father/brother, etc
  47.        won't be able to UNDELETE and read it.
  48.      - Erase all files and directories (including the volume label) on
  49.        drive A, without any prompting.    
  50.      - etc........
  51.       
  52.      (I could go on for hours, but that would be a waste 
  53.       of disk space and paper)
  54.  
  55.   I think you will have quite some trouble with the given examples, 
  56.   if all you can use is DEL and DELTREE. It would probably take a 
  57.   lot of time, IF it's even possible to do it.
  58.   I hope that you now see the use of this program, if you 
  59.   don't, than I think you better DELete this program and 
  60.   continue your game of PacMan.
  61.  
  62.  
  63.   FEATURES
  64.  
  65.   The FastErase program includes some very powerfull features, 
  66.   which enable you to do everything stated in the list above 
  67.   and more. These features are:
  68.  
  69.       - Erase up to sixteen file/directory specifications in ONE command.
  70.       - Erase entire directory structures
  71.       - Search through an entire drive for files to be erased
  72.       - Select files on date and/or size
  73.       - Exclude files with specific attributes from being erased.
  74.       - Exclude up to seven files specifications from being erased.
  75.       - Ask permission before erasing each file.
  76.       - For optimum security, you can make erased files unrecoverable,
  77.         so no one will ever be able to recover the erased data.
  78.       - List details about the files that are erased.
  79.       - Supports redirection (FE > file)
  80.  
  81.  
  82.   PROGRAM REQUIREMENTS
  83.  
  84.   The requirements for running this program are:
  85.  
  86.      * An IBM PC or compatible computer
  87.      * DOS version 3.0 or higher
  88.      * About 75K of memory (max)
  89.  
  90.  
  91.   HOW IT WORKS
  92.   
  93.   The FastErase program must be started from the DOS command 
  94.   prompt, like this: 
  95.   
  96.               C:\>FE <file(s)> [options]
  97.   
  98.   All information needed to run the program must be supplied after
  99.   the program name, this information consists of the following:
  100.   
  101.       - The name(s) of file(s) and/or directories to erase.
  102.         You can specify a maximum of sixteen file/directory
  103.         names. The files/directories may be on different
  104.         drives.
  105.         
  106.         Note: The program assumes that any information specified 
  107.               on the command line that doesn't start with an option 
  108.               marker ("/") is the name of a file or directory to erase.
  109.               
  110.       - Options, as implied by the name, are optional, the program
  111.         doesn't need them to operate, but you can use them to control
  112.         the working of FastErase. Options always start with an option
  113.         marker, "/", and can be one of the following:
  114.         
  115.         /? Displays command line help
  116.            This options displays a short help screen on the usage
  117.            of the program. The help screen is also displayed if no
  118.            command line information is supplied, so you don't really
  119.            need this option, but it's included for compatibility.
  120.         
  121.         /Q Prompt before erasing each file
  122.            When this option is specified, the program will ask for
  123.            your permission before it erases each file.
  124.            
  125.         /R Search through all subdirectories
  126.            With this option on, the program will search through all
  127.            subdirectories of the specified drive for files to be erased.
  128.         
  129.         /T Test mode
  130.            When you specify this option, the program will function
  131.            normally, except for one (very important) thing: it will 
  132.            NOT erase any files and/or directories.
  133.         
  134.         /U Make erased files unrecoverable
  135.            When you specify this option, the program will destroy
  136.            the specified file(s), which means that they cannot be
  137.            recovered in ANY way, the data will be gone FOR EVER.
  138.            You are strongly advised to use this option with great care.
  139.            
  140.         /V Verbose output
  141.            This option will display information about the files that
  142.            are erased. The information will consist of the full name
  143.            of the file, its size, its date and time, and its attributes.
  144.            You can redirect the output of the program to a file or to
  145.            your printer, in this way:
  146.            
  147.                C:\>FE <filename(s)> [options] /V > <outputfile>
  148.            
  149.            You can also use the MORE command to view the output one
  150.            screen at a time by using this command:
  151.  
  152.                C:\>FE <filename(s)> [options] /V | MORE
  153.  
  154.            Please refer to your DOS documentation for a detailed explanation
  155.            of redirection.
  156.            
  157.         /DA:date Erase files created after date
  158.            When you specify this option, the program will only erase
  159.            files that are dated after the given date. The date must
  160.            be supplied in the format: mmddyy
  161.            By example January 4th, 1994 becomes: 010494
  162.         
  163.         /DB:date Erase files created before date  
  164.            This option has the same effect as the /DA option, but
  165.            now only files created before the given date will be
  166.            erased. Note that both date options can be used at the
  167.            same time to define a date range.
  168.         
  169.         /SB:size Erase files bigger than size       
  170.            With this option, the program will only erase files
  171.            with a size bigger than the given size. The size
  172.            must be specified in bytes.
  173.         
  174.         /SS:size Erase files smaller than size
  175.            This option has the same effect as the /SB option, but now
  176.            only files smaller than the given size will be erased.
  177.            Note that both size options can be used at the same time
  178.            to specify a size range.
  179.            
  180.         /A:attr Exclude files with attributes from being erased
  181.            With this option, you can specify that you don't want
  182.            to erase files with special attributes. These attributes
  183.            are identified by a letter, these letters are:
  184.            
  185.               R - Read Only files
  186.               H - Hidden files
  187.               S - System files
  188.               V - Volume labels
  189.             
  190.            Any combination of these letters is possible.
  191.            By example, if you don't want to erase System files and
  192.            Volume labels, you have to specify /A:SV (or /A:VS)
  193.            Please see your DOS documentation for a detailed
  194.            explanation of file attributes.
  195.            
  196.                   
  197.        /X:file[,...] Exclude files from being erased.
  198.           Use this option to exclude certain files from being erased.
  199.           The name(s) of files to be exclude may contain wildcards, but
  200.           no drive and/or path information. You can specify up to seven
  201.           names, separated by commas, with NO spaces.
  202.           By example, if you don't want to erase all files that have
  203.           the extention .SYS and the file COMMAND.COM, you have to
  204.           specify /X:*.SYS,COMMAND.COM.
  205.           Please not that there may be NO spaces between the filename(s)
  206.           to exclude, if you do put spaces between them, the files you
  207.           wanted to exclude will be erased!
  208.  
  209.   
  210.   IMPORTANT NOTE ON OPTIONS
  211.  
  212.   Please note that when you specified the name of a directory to erase,
  213.   the following options will have NO effect at all at the operation of
  214.   the program. Directories will totally be erased without any prompting.
  215.  
  216.   These options have NO effect at the process of erasing directories:
  217.  
  218.        /Q, /R, /DA, /DB, /SB, /SS, /A, /X
  219.  
  220.   Please remember this, it's VERY important!
  221.  
  222.  
  223.   EXAMPLES
  224.  
  225.   As examples I will use the list given in the INTRODUCTION section.
  226.  
  227.      Example 1: Erase all .BAK files on drive C
  228.   Command line: FE C:\*.BAK /R
  229.  
  230.      Example 2: Erase all .BAK files on drives C, D, E and F
  231.   Command line: FE C:\*.BAK D:\*.BAK E:\*.BAK F:\*.BAK /R
  232.  
  233.      Example 3: Erase all .BAK files and all .OLD files on drive C
  234.   Command line: FE C:\*.BAK C:\*.OLD /R
  235.  
  236.      Example 4: Erase all files on drive C, created before
  237.                 September 24th, 1987
  238.   Command line: FE C:\*.* /DB:092487 /R
  239.  
  240.      Example 5: Erase all files on drives C and E, created between
  241.                 October 11th, 1989 and May 17th, 1991
  242.   Command line: FE C:\*.* E:\*.* /DA:101189 /DB:051701 /R
  243.  
  244.      Example 6: Erase all files on drive C, with a length of zero 
  245.                 bytes (empty files)
  246.   Command line: FE C:\*.* /SS:1 /R
  247.  
  248.      Example 7: Erase all .BAK files on drive C, EXCEPT all files 
  249.                 named MIRROR.BAK
  250.   Command line: FE C:\*.BAK /R /X:MIRROR.BAK
  251.  
  252.      Example 8: Erase all files on drives C and F, beginning with 
  253.                 the letter C, EXCEPT all files named COMMAND.COM
  254.                 and CONFIG.SYS.
  255.   Command line: FE C:\C*.* F:\C*.* /R /X:COMMAND.COM,CONFIG.SYS
  256.  
  257.      Example 9: Erase your computer diary, stored in file DIARY.DOC,
  258.                 but make it unrecoverable so your wife/husband/mother/
  259.                 father/brother/etc. won't be able to UNDELETE and read it.
  260.   Command line: FE DIARY.DOC /U
  261.  
  262.     Example 10: Erase all files and directories (including the volume label)                                     on drive A, without any prompting.  
  263.   Command line: FE A:\
  264.  
  265.  
  266.   EXIT CODES
  267.  
  268.   The program returns exit codes, which can be used in batch files.
  269.   The following exit codes can be returned:
  270.  
  271.      0 - No errors occurred
  272.      1 - Incorrect command line
  273.      2 - Path not found
  274.      3 - Drive is not ready
  275.      4 - Drive is write protected
  276.      5 - Disk error
  277.      6 - File error
  278.      7 - Disk read error
  279.      8 - Disk write error
  280.      9 - Not enough memory
  281.     10 - Program was aborted by Ctrl-Break
  282.    255 - Unknown error  
  283.   
  284.  
  285.   TESTING THE PROGRAM YOURSELF
  286.  
  287.   The best way to find out how this program really works, and what
  288.   every option does, is by using it. To test it, always run the
  289.   program in Test mode (The /T option), so you can be sure that nothing
  290.   will be erased. You can also use the Verbose (/V) and Prompt (/Q)
  291.   options for testing purposes. This way you can also convince yourself
  292.   that it's really safe to use this program and that it will never erase
  293.   anything else than what you tell it to.
  294.  
  295.  
  296.   DISCLAIMER
  297.   (Non-lawyers can skip this section)
  298.  
  299.   The FastErase (FE) program is provided on an "as is"
  300.   basis, Arjen Wolfs can in no way be liable for any damage,
  301.   whether direct, indirect or consequential, that could arise 
  302.   from the use or misuse of this software. The user of this 
  303.   software bears all risks as to the quality and performance 
  304.   of this software.
  305.  
  306.  
  307.   DISTRIBUTION/USAGE RESTRICTIONS
  308.  
  309.   The FastErase program is FREEWARE, it may be freely used and copied,
  310.   as long as the following conditions are met:
  311.  
  312.     - The program must remain in its complete form.
  313.     - The program itself, nor this document may be changed.
  314.     - No fee may be charged for the program itself, but
  315.       a small fee may be charged for distribution.
  316.     - This program may not be used in a commercial enviroment.
  317.     
  318.   I did not wrote this program to make money out of it, but
  319.   even more, I did not wrote this program for OTHER people
  320.   to make money out of it!
  321.  
  322.   CONTACTING THE AUTHOR
  323.  
  324.   I have included all functions I found useful in this program,
  325.   though if you have any suggestions, contact me and I'll have
  326.   a look if it's worth adding to the program.
  327.   If you find any bugs in this program, PLEASE report it to me so
  328.   I can remove them. I can be reached at this adress:
  329.  
  330.        Arjen Wolfs
  331.        Pr. Margriethof 96
  332.        1411 BZ Naarden
  333.        The Netherlands
  334.